home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 028a / acs_v200.zip / MANUAL.ACS < prev   
Text File  |  1991-08-10  |  12KB  |  331 lines
  1.  
  2.   PROGRAM MANUAL - Archive Converter/Scanner v2.0α
  3.  
  4.  
  5.  
  6.  
  7.       ▌
  8.      ▌▌▌
  9.     ▌▌ ▌▌
  10.    ▌▌▌▌▌▌▌   ▌▌▌▌▌
  11.    ▌▌   ▌▌  ▌▌   ▌▌
  12.             ▌▌
  13.             ▌▌   ▌▌   ▌▌▌▌▌
  14.              ▌▌▌▌▌   ▌▌
  15.                       ▌▌▌▌
  16.                          ▌▌
  17.     Version 2.0α     ▌▌▌▌▌            Copyright (c) 1990, 1991  Vikram Rao
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                                Table Of Contents
  26.                                ~~~~~~~~~~~~~~~~~
  27.  
  28.               Agreement........................................1
  29.  
  30.               Introduction.....................................2
  31.  
  32.               Requirements.....................................2
  33.  
  34.               Set-Up/Operation.................................3
  35.  
  36.               Thanks...........................................5
  37.  
  38.               Copyrights.......................................6
  39.  
  40.  
  41.  
  42.  
  43.  
  44. AGREEMENT:
  45. ~~~~~~~~~    This software may be freely distributed in the Public Domain so
  46. long as the software and accompanying documentation remain unmodified and *NO*
  47. fee of consideration has been paid to obtain the ACS software package.  You
  48. are to be held fully responsible IF any damage is caused by the use of this
  49. program.  If you use this program on a regular basis I would really appreciate
  50. some feedback as to what should be improved/fixed for future releases.
  51.  
  52.  
  53.  
  54.                                     - 1 -
  55.  
  56.  
  57.  
  58.  
  59. Introduction to A.C.S:
  60. ~~~~~~~~~~~~~~~~~~~~~    What the heck is A.C.S.?   Well, A.C.S. is an acronym
  61. for Archive Converter/Scanner.  The purpose behind A.C.S. is to allow a SysOp,
  62. or user, to convert and virus scan, any directory of archives without having
  63. to manually do such a boring job.  The task that A.C.S. performs can be a three
  64. to five step process as follows: [ * Indicates definite steps ]
  65.  
  66.  
  67.           * 1] The archive is extracted to a work directory.
  68.  
  69.             2] If McAffee's SCAN.EXE exists in any path directory the
  70.                 archive's contents will be virus scanned.
  71.                - Any virus infected files will be eliminated by SCAN.EXE
  72.  
  73.             3] If the file ACS.CAN exists in the same directory as ACS.EXE
  74.                 and contains up to nine valid file names those files will
  75.                  be destroyed in the A.C.S. temporary work directory.
  76.  
  77.           * 4] Any internal archives will undergo steps one to five
  78.  
  79.           * 5] The archive is re-archived to it's original directory
  80.                 with file date and time intact.
  81.  
  82.  
  83.  
  84.      How did A.C.S. come about?  Two years ago I made a 50 line Basic program
  85. to convert ARC/LZH and PAK archives to the then undisputed champion of archive
  86. methods, ZIP.  A short time later a friend of mine, and a SysOp of a BBS, showed
  87. some interest in my little program but required a more enhanced version - one
  88. that would also scan for the existence of viruses, and allow conversion to any
  89. of five methods (ARC,LZH,PAK,ZIP,ZOO) not just to ZIP.  Anyway, to make a long
  90. story short, since that time A.C.S. has grown to support eight archive methods
  91. (ARC,ARJ,DWC,HYP,LZH,PAK,ZIP,ZOO), and has continued to add many other new and
  92. powerful features - too numerous to mention here.  For a detailed look at how
  93. A.C.S. has evolved over the last year take a look at the HISTORY.ACS file.
  94.  
  95.  
  96.  
  97.  
  98. Requirements:
  99. ~~~~~~~~~~~~     This program may be run on any IBM class machine, excluding
  100. the PC-Jr.  The use of a hard drive is recommended as it will speed up the
  101. conversion process, and allow LARGER files to be converted and scanned.  For
  102. example, if you are converting a 100K file - A.C.S. requires at least 250K of
  103. free disk space to operate; thus on a 360K floppy a 100K file is about the
  104. biggest archive you can convert.  As far as free memory goes, you must have
  105. enough RAM free to run your favourite archiver + 64K for A.C.S..
  106.  
  107.  
  108.  
  109.                                     - 2 -
  110.  
  111.  
  112.  
  113.  
  114. Getting A.C.S. Ready For Use:
  115. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~    Setting up A.C.S. is a very easy task -
  116. provided you have a path directory, or at least know how to get one 8), and
  117. you know how to copy files..  After you have unarchived the ACS-v200.ZIP
  118. archive, and read through this documentation, follow these set-up steps:
  119.  
  120.    1] Simply copy the ACS.EXE file into one of your path directories.
  121.  
  122.    2] Make certain that SCAN.EXE exists in any of your path directories.
  123.       - This is optional if you don't require your achives to be scanned.
  124.  
  125.    3] Make certain that any archivers that you are planning to use exist in
  126.        any one of your path directories.
  127.       - All eight archive methods need not exist on your drive; just the
  128.          method that you are converting to and the un-extracters for the
  129.           archive types that you are converting from.
  130.  
  131.    4] Pat yourself on the back - A.C.S. is ready to roll...
  132.  
  133.  
  134.  
  135.  
  136. Operation Of A.C.S:
  137. ~~~~~~~~~~~~~~~~~~      A simple information screen can be displayed by just
  138. typing "ACS" from anywhere on your drive (so long as you have copied the
  139. ACS.EXE into a recognized path directory).  If nothing happens when you type
  140. "ACS" at any prompt, then you have installed A.C.S. improperly (not in a DOS
  141. path directory) and should refer to your DOS manual or follow the Set-Up steps
  142. again.  If ACS is installed properly you should see the following:
  143.  
  144.               USAGE:   ACS [Drive:\Path\]WildCard.Ext /[EXT] [OK]
  145.               ═════
  146.                       [EXT] -=> Is The Method To Convert Files To
  147.                                 (ARC|ARJ|DWC|HYP|LZH|PAK|ZIP|ZOO)
  148.  
  149.                        [OK] -=> Switch To Use For Non-Prompt Mode
  150.  
  151.  
  152.      Great!  So what does all this mean?  It's all quite self explanatory,
  153. however, I'll go into more detail to help those who may need it.
  154.  
  155. [Drive:\Path\] - Is the drive and directory where the files to be converted
  156.                  and scanned are located. ( Eg, "C:\ARCFILES\" )
  157.  
  158.  WildCard.Ext  - This can be any valid DOS file wildcard - and specifies the
  159.                  actual file name(s) you want to be converted and scanned.
  160.                  ( Eg, 'LIBRARY.ARC' | 'DiskNo??.ZIP' | '*.ZIP' | '*.*' )
  161.  
  162.  
  163.  
  164.                                     - 3 -
  165.  
  166.  
  167.  
  168.  
  169.     /[EXT]     - The value after the '/' must be one of ARC,ARJ,DWC,HYP,LZH,
  170.                  PAK,ZIP, Or ZOO.  The three character extension signifies
  171.                  the method of conversion you wish - Upper and lower case
  172.                  characters are treated equally.
  173.  
  174.      [OK]      - This switch is completely optional.  If you include 'OK' at
  175.                  the end of your command line for ACS.EXE, a faster batch mode
  176.                  will be initiated.  This means that A.C.S. will not require
  177.                  any further input from you to operate and exit.  For example,
  178.                  if this switch is not used, the user is forced to push [Y]es
  179.                  or [N]o to process the files, and <Enter> upon completion of
  180.                  converting and scanning to return to the DOS environment.
  181.                  With 'OK' at the end of the command line A.C.S. assumes that
  182.                  everything is ok and proceeds automagically.  - This is
  183.                  obviously a handy feature for the SysOp running A.C.S. as
  184.                  an event in the wee hours of the morning.
  185.  
  186.  
  187.  
  188. Example 1]   ACS *.* /ARJ
  189.           - This converts and scans any files of the eight supported methods
  190.            that exist in the current directory to the ARJ format - A.C.S. will
  191.            require further input from the user to process the files and exit.
  192.  
  193. Example 2]   ACS E:\FileArea\*.PAK /LZH OK
  194.           - This converts and scans all PAK files in the directory E:\FileArea\
  195.            to the LHA format.  Since the OK switch exists, A.C.S. will not
  196.            require any further input from the user - Good for BBS events.
  197.  
  198. Example 3]   ACS FileArea\* /ZIP OK
  199.           - This converts and scans any files of the eight supported methods
  200.            that exist on the current drive and in the directory \FileArea\ to
  201.            the ZIP format.  Again, since the OK switch exists A.C.S. will
  202.            operate without need for further keyboard input.
  203.  
  204.  
  205.  
  206. Other Features:
  207. ~~~~~~~~~~~~~~     Another feature of A.C.S. is the trashcan file.  If a file
  208. called 'ACS.CAN' exists in the same path as the 'ACS.EXE' file, and this file
  209. contains up to nine legal file names (No * or ?) - A.C.S. will remove any
  210. listed files from within all archives being converted.  This is a very handy
  211. feature for removing those pesky 'BBS.AD' files that many BBS's insert into
  212. every archive on their BBS.   A sample 'ACS.CAN' file has been included to
  213. remove several known BBS ads from within your archives.   To deactivate this
  214. feature simple make sure that the 'ACS.CAN' file does not exist in the same
  215. directory as the 'ACS.EXE' file.
  216.  
  217.  
  218.  
  219.                                     - 4 -
  220.  
  221.  
  222.  
  223.  
  224.      Also, if a virus IS found by scan the file 'ACSVIRUS.LOG' will be created
  225. in the directory where the files being converted and scanned were originally
  226. located.  This log will contain information about any virus found by scan.  The
  227. final feature is that the <ESC> key can be pressed at any time causing A.C.S.
  228. activity to be halted with an exit prompt.
  229.  
  230.      A.C.S. returns a result code upon termination (natural or otherwise), they
  231. are as follows:
  232.                   0 = Success - No Problem-O
  233.                   1 = Aborted by <ESC> from keyboard
  234.                   2 = No archives to convert located
  235.                   3 = The /[EXT] archiver does not exist
  236.                   4 = The \ACS\ work directory already exists
  237.                   5 = ACS or RAM has been tampered with or have a virus
  238.                  99 = Unknown - Please Report This Error To Me!!!
  239.                       ( See Thanks Below )
  240.  
  241.  
  242.  
  243.      A.C.S. has been tested with the following archive formats/versions.
  244.          (And versions 3.1v60 -> 7.6v80 of McAffee's virus scanner)
  245.  
  246.                ARJ.EXE ................... v2.00 -> v2.20
  247.                DWC.EXE ................... v4.95A
  248.                HYPER.EXE ................. v2.50
  249.                LHA.EXE ................... v2.00 -> v2.12
  250.                PAK.EXE ................... v2.51
  251.                PKPAK.EXE/PKUNPAK.EXE ..... v3.61
  252.                PKZIP.EXE/PKUNZIP.EXE ..... v1.10
  253.                ZOO.EXE ................... v2.01
  254.  
  255.  
  256.  
  257.  
  258.  
  259. Thanks:
  260. ~~~~~~     I'll take this opportunity to thank all those who have supported
  261. A.C.S. from it's early development stages.  Many thanks go out to Ray Dyer,
  262. Jim Duffield, Nick Itsou, Erwin Nanes, and Trevor Short for their support and
  263. excellent suggestions.  When A.C.S. was first released I requested comments and
  264. suggestions to improve A.C.S. - and threatened that if I didn't receive any
  265. feedback A.C.S. development would stop.  It is thanks to these, and other
  266. people, that I've continued enhancing A.C.S. to what it is today.  I know that
  267. A.C.S. has not reached it's potential yet, and I still need further comments
  268. and suggestions to help improve future releases of A.C.S..  I can be reached
  269. on: BlakStar Systems BBS  (416)656-4532   1:250/646.0   The latest version of
  270. A.C.S. should also be available on this BBS as well.
  271.  
  272.  
  273.  
  274.                                     - 5 -
  275.  
  276.  
  277.  
  278.  
  279. Copyrights:
  280. ~~~~~~~~~~     In NO way, does A.C.S. change the coding of the software it
  281. works in conjunction with.  Many thanks go to the writers of the following
  282. programs for creating excellent archive and virus detection utilities.
  283.  
  284.  
  285.    SCAN        v7.60v80  - Copyright (c) 1989-1991  McAfee Associates
  286.  
  287.    ARJ         v2.20     - Copyright (c) 1990-1991  Robert K. Jung
  288.    DWC         v4.95A    - Copyright (c) 1986-1988  Dean W. Cooper
  289.    HYPER       v2.50     - Copyright (c) 1989-1990  P. Sawatzki & K.P. Nischke
  290.    LHA         v2.12     - Copyright (c) 1988-1991  Haruyasu Yoshizaki
  291.    PAK         v2.51     - Copyright (c) 1988-1990  NoGate Consulting
  292.    PK[UN]PAK   v3.61     - Copyright (c) 1986-1988  PKWare INC.
  293.    PK[UN]ZIP   v1.10     - Copyright (c) 1989-1990  PKWare INC.
  294.    ZOO         v2.01     - Copyright (c) 1988       Rahul Dhesi
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.                                     - 6 -
  330.  
  331.